Inside Macintosh: Telephony /

Chapter 5 - Telephone Manager Messages / Telephone Manager Message Reference

Telephone Manager Message Functions

Registering Message Handlers

You use the functions described in this section to register your message handlers with the Telephone Manager. When a telephone tool detects some sort of activity, such as a change of state of a call appearance, the telephone tool sends notification to the Telephone Manager which, in turn, calls your message handler.

The Telephone Manager sends three types of messages: messages about the terminal as a whole, messages about particular directory numbers, and messages about particular call appearances. Your application must provide at least one message-handling routine (message handler) for each of the three message types.

The Telephone Manager keeps a list of all message handlers for all applications. When you register a message handler with the Telephone Manager, you must specify which messages the handler is to receive.

You can register more than one message handler of each type. For example, you might register several directory number message handlers. Each such handler could be registered to receive a different set of messages. Each time a tool processes a telephone network event, the tool sends one or more messages to the Telephone Manager. The Telephone Manager then relays the message to all message handlers registered to receive that kind of message.

---

Subtopics

TELTermMsgHand

TELDNMsgHand

TELCAMsgHand